home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr09
/
prntcard.zip
/
PRNTCARD.DOC
< prev
next >
Wrap
Text File
|
1993-06-17
|
21KB
|
529 lines
PRNTCARD - Print 3" by 5" Card Program
Version 0.4 20 July 1989
Copyright (c) 1989 by Joseph R. Wood
Permission is granted to copy for noncommercial or nonprofit
purposes only. All other rights reserved.
----------------------------------------
This program was written by:
Joseph R. Wood
5705 Laurel Avenue
Raytown, Missouri 64133
(816) 358-4173
Introduction
-----------------------------------------------------------------
I am a member of the Ohio Genealogical Society (OGS). One of the
services they provide is an Ancestor Card File. This file
consists of members pedigree charts and a 3" by 5" card file to
index the names on the pedigree charts. When two cards are found
to be the same person, each member submitting those cards will be
notified of the other's interest.
This program will produce the 3" by 5" index cards for the OGS
Ancestor Card File. It is not exactly in the format that they
suggest because I could not get all the information they wanted
on one card. However, I believe it does provide the information
they need. This program could be used to print cards of ancestor
information for other purposes than the OGS Ancestor Card File.
Below is a how a sample card appears.
FOSTER, Lucy Ann
Father: FOSTER, Isaac Giles
Mother: CHENEY, Roxanna
B- 1 Apr 1853 Plainfield,Will,Illinois
M-18 Nov 1869 Goleta,S,California
D-31 May 1927 Santa Barbara,S,California
Husband: SEXTON, Joseph
Date Prepared Joseph R. WOOD
07/20/89 5705 Laurel Avenue
Raytown, Missouri
64133-3259
(816) 358-4173
Requirements
-----------------------------------------------------------------
This program runs on an IBM PC or compatible with at least 256K
memory using DOS 2.0 or greater. Be sure to have at least 20
files available from DOS by having the command "FILES=20" in
CONFIG.SYS. If you have FILES greater than 20, that is OK.
This program depends on two programs: "Personal Ancestral File"
(PAF) available from the Church of Jesus Christ of Latter-day
Saints, and "Family Roots to System Data Format Program"
(FR2SDF). This program is available with PRNTCARD. FR2SDF
converts PAF Family Records data into System Data Format (SDF)
files. PRNTCARD takes these SDF files and changes them into
dBASE III database files.
This conversion process takes a lot of disk space, about 500
bytes for each PAF Family Record. Therefore, PRNTCARD will
probably run best on a hard disk system. To run on a floppy disk
system, see the Floppy Disk Operation paragraph below. As an
example of the file size involved I took a 1,700 person PAF
database and converted it. PRNTCARD's final database files took
up about 500,000 bytes of space.
Continuous feed 3" by 5" cards work the best. This program uses
no special printer control characters so it should run on any
printer.
File Conversion
-----------------------------------------------------------------
FR2SDF should be run with the following command:
FR2SDF [datapath]
[datapath] is the disk or directory of the Family Records
data. It is optional. Do not include the brackets [] when
specifying a datapath. If a datapath is not specified, the
default drive is used. If FR2SDF does not understand the
datapath entered, or cannot find the PAF files, it will display
an error message, what it cannot find, and terminate.
Running PRNTCARD
-----------------------------------------------------------------
When FR2SDF has completed, start PRNTCARD by entering the
command:
PRNTCARD
There are no options to the command. When PRNTCARD starts, it
checks to see if there is any data in its INDIV2.DBF file. If
there is no data, it automatically starts the routine to convert
the FR2SDF files. If the PAF database is large, the conversion
could take a few minutes. When the FR2SDF files are converted,
they are deleted.
When the files have been converted, or PRNTCARD finds data in the
INDIV2.DBF file, it will present a menu of options.
- 2 -
PRNTCARD MAIN MENU 07/20/89
=================================================================
OPTIONS:
0 Quit Program
1 Enter your name and address
2 Print 3 X 5 card
3 Print 3 X 5 card to a file
4 Print continuous cards
5 Reload database files
SELECT OPTION: _
Quit Program
-----------------------------------------------------------------
This option will stop the program and return the control of the
computer to DOS.
Enter your name and address
-----------------------------------------------------------------
This option will bring up a screen for your name, address, and
telephone number. Enter them as you want them to appear on the
printed cards. These fields are a little shorter than usual in
order to put them on the card and leave room for a hole in the
bottom middle of the card. When you get the information entered
the way you want it, press <Enter> while on the last line to save
it. These fields may be made blank if you do not want to print
your name, address, and telephone number on the cards. When the
first line is blank, the "Date Prepared" and date will not appear
on the card.
Print 3 X 5 card
-----------------------------------------------------------------
This is the main part of the program. This routine only prints
one card at a time. It asks for a RIN (Record Identification
Number) of the person the card is for. This is the same RIN the
person has in PAF. When an RIN is entered, it finds the person
and asks you if this is the correct person. If the person is
correct, then it prompts you to align the card for print. When
the card is aligned, press any key to print it. The screen will
echo what is printed on the printer. When the card has printed,
the program prompts you to press any key to continue. Continue
entering RINs and printing cards until all the ones you want are
printed.
I would like to be able to specify an ancestor and print cards
for "x" generations unattended. However, I have not come up with
an algorithm to do this. So I added the "print continuous cards"
option. I suggest that when you print the pedigree charts you
are going to submit, you print an index to the pedigree charts
(using PAFUTIL). Then use this index with the "print continuous
cards" option.
- 3 -
The line that prints the person's birth, marriage and death
information has the potential of being 84 characters long.
Because of this, the place fields are abbreviated if necessary.
The following convention is followed. The date is always
printed. The first and fourth place fields are always printed if
they have data in them. If the line is too long, the second
place field is truncated to its first character. If the line is
still too long, the third place field is truncated to its first
character. There is a possibility the line may still be too
long. However, it is believed the possibility is small and the
line would not make much sense without the date, first and fourth
fields as a minimum.
Print 3 X 5 card to a file
-----------------------------------------------------------------
This is pretty much the same as printing a card to the printer.
The main difference is that the output is directed to a file,
PRNTCARD.PRN to be exact.
The program always prints to PRNTCARD.PRN on the default drive.
If the PRNTCARD.PRN file already exists, it will be overwritten.
So if you want to save the information that has been printed to a
file, rename PRNTCARD.PRN.
Print Continuous Cards
-----------------------------------------------------------------
This option looks for a file called "PRNTCARD.TXT". This file
should have a list of RINs to print. The RINs must start in
column 33 of the file and be left justified. This routine was
designed to take the index that is printed at the end of the
Cascading Pedigree Report from PAFUTIL and print the RINs on it.
This routine ignores everything except values it can convert to
RINs in columns 33-37 of the file. For example, this routine
will take the index report as-is and ignore fields it cannot
recognize as RIN's. If the Cascading Pedigree Report is printed
to disk, and the index is requested, the entire file can be
loaded into a word processor, and the index can be separated from
the pedigree charts. After the RIN database file is created, the
program prompts to print the cards to the printer. If you answer
anything except 'Y', the routine will print to a file
(PRNTCARD.PRN). I suggest you print the index cards to a file
instead of the printer.
Reload Database Files
-----------------------------------------------------------------
This option will erase all records in the PRNTCARD files, and
converts a new set of SDF files. If you make some changes or add
new ancestors into PAF, you will want to run FR2SDF again and
then use this option to update the PRNTCARD files. For a large
PAF database, this could take a few minutes.
- 4 -
Technical Details
-----------------------------------------------------------------
PRNTCARD is a Clipper compiled dBASE III Plus program. The files
and indexes it uses should be compatible with dBASE III or dBASE
III Plus.
FR2SDF is a Turbo Pascal (Version 4.0) program. It does reads
only on the PAF files, so it should do no damage to them.
However, a back-up should be done, "just in case".
The following are the files of the program. The index files are
created by the file conversion process.
FILE: PRNTCARD.EXE
This is the executable program file.
FILE: FR2SDF.EXE
This is an executable program to convert PAF files to SDF files.
FILE: PRNTCARD.DOC
This is the documentation for the program, and is this file you
are currently reading. This file can printed by issuing the
command:
COPY PRNTCARD.DOC LPT1:
FILE: PRNTCARD.PRN
This is the file that the program writes to when the cards are to
be written to a file. This file is created if it does not exist.
If it does exist, it is overwritten.
FILE: NAMADD2.DBF
This is the file that holds the name and address of the person
submitting the 3" X 5" ancestor card. This database has one and
only one record. Its structure is shown below:
Field Field Name Type Width Contents
1 NNAME Character 20 Submitter's Name
2 NADDR1 Character 25 Address Line 1
3 NADDR2 Character 25 Address Line 2
4 NADDR3 Character 25 Address Line 3
5 NPHONE Character 14 Phone Number
** Total ** 110
FILE: INDIV2.DBF
INDEX: INDIV2.NDX (Indexed on IRIN)
This is the file that holds the individual's data. It's
structure is shown below:
- 5 -
Field Field Name Type Width Contents
1 IRIN Character 5 Individual RIN (from PAF)
2 ISURNAME Character 16 Surname
3 IGNAME1 Character 16 Given name 1
4 IGNAME2 Character 16 Given name 2
5 IGNAME3 Character 16 Given name 3
6 ISEX Character 1 Sex
7 IRINOS Character 5 RIN of Older Sibling
8 IMRINOM Character 5 MRIN of Marriage
9 IMRINPM Character 5 MRIN of Parent's Marriage
** Total ** 86
FILE: MARR2.DBF
INDEX: MARR2.NDX (Indexed on MMRIN)
This is the file that holds all of the marriage records of
individuals. It's structure is shown below:
Field Field Name Type Width Contents
1 MMRIN Character 5 Marriage Rec ID No (MRIN)
2 MHRIN Character 5 Husband's RIN
3 MWRIN Character 5 Wife's RIN
4 MCRIN Character 5 Youngest Child's RIN
5 MHOMMRIN Character 5 H'band's Oth Marriage MRIN
6 MWOMMRIN Character 5 Wife's Other Marriage MRIN
7 MDIVFLAG Character 1 Divorce Flag
** Total ** 32
FILE: EVENT2.DBF
INDEX: EVENT2.NDX (Indexed on ERIN + EEVNT_TYP)
This is the file that holds all of the events associated with a
person, such as birth, death, marriage, etc and when and where
they occurred. It's structure is shown below:
Field Field Name Type Width Contents
1 ERIN Character 5 Event Indivdual's RIN
2 EEVNT_TYP Character 4 Event Type Code
3 EDATE Character 20 Date
4 EPLACE1 Character 16 Place Name 1
5 EPLACE2 Character 16 Place Name 2
6 EPLACE3 Character 16 Place Name 3
7 EPLACE4 Character 16 Place Name 4
** Total ** 94
FILE: RIN2.DBF
This is the file that holds all of the RINs that are to be
printed continuously. It's structure is shown below:
Field Field Name Type Width Contents
1 NAME Character 33 Not used by the program
2 TEMP_RIN Character 5 A RIN to be converted
3 FILLER Character 36 Not used by the program
4 RIN_NUM Character 5 A converted RIN
** Total ** 80
- 6 -
Floppy Disk Operation
-----------------------------------------------------------------
Although this program works best on a hard disk system, a floppy
disk system could be used if file sizes were kept small. A way
to do this is to use GEDCOM to create a file of the persons you
want to create cards for. Then create a new separate PAF
database with just those persons in it. Then convert this small
database using FR2SDF and PRNTCARD as described above.
In order to save space on your data disk (assumed to be in drive
B:), you should have PRNTCARD on your program disk (assumed to be
in drive A:). PRNTCARD's data files should be on the data disk.
For the program to work properly, you must switch to the data
disk to establish it as the default disk and then run PRNTCARD
from drive A:. These are the commands you would use:
B: <Enter>
A:PRNTCARD <Enter>
The command B: establishes drive B: as the default drive. The
command A:PRNTCARD tells the computer to execute PRNTCARD from
the A: drive. FR2SDF can be executed the same way.
ERRORS
-----------------------------------------------------------------
Although I have made every effort to "bulletproof" this program,
there will probably be some errors in it. Please contact me with
any errors you encounter. I will want to have the following
information when an error occurs:
A screen print of the screen when the error occurs.
What keystrokes you used to get the error.
Can the error be duplicated with those same keystrokes?
Your computer configuration (floppy disk or hard disk) and memory
capacity.
Version of DOS you are using.
Also, should you have any enhancements or suggestions for the
program, I would appreciate hearing about them.
MODIFICATIONS
-----------------------------------------------------------------
If the name is blanked out of the NAMADD2 record, the "Date
Prepared: " and date are not printed.
A new option was added to print cards from a file of RINs. This
required a new database file, RIN2.DBF.
A new program was written, FR2SDF, to convert the PAF files to a
form that PRNTCARD can use. This program converts the data about
3 times faster the previous program used. It produces files that
are about 1/4 the size of the files produced by the previous
program. The smaller conversion files save a great deal of space
when converting a large database. This new program allows 5
- 7 -
character RINs to be used instead of 6 character RINs. This
saves a little bit of space.
The Youngest Child Pointer RIN was added to the MARR2 database.
The event RIN (or MRIN for marriages) was moved from the end of
the record to the beginning of the record for the EVENT2
database.
The converted dates are consistent in their placement within the
field. For example, the year will always start in byte 12 of the
date field.
AVAILABILITY
-----------------------------------------------------------------
I have made this program available to the Ohio Genealogical
Society and some Genealogy BBSs. This program is also available
from me. Please send a MSDOS formatted 3 1/2" or 5 1/4" disk
with return postage, and I will copy the program onto the disk
and return it.
TRADEMARKS
-----------------------------------------------------------------
dBASE III and dBASE III PLUS are Trademarks of Ashton-Tate.
Nantucket and Clipper are Trademarks of Nantucket Corporation.
Turbo Pascal is a Trademark of Borland International.
Personal Ancestral File is a Trademark of the Corporation of the
President of The Church of Jesus Christ of Latter-day Saints.
IBM is a registered Trademark of International Business Machines,
Inc.
- 8 -